Obtains a control’s current setting.

SInt16 GetControlValue (
    ControlRef theControl
);

theControl

On input, a handle to a control.

function result

The current setting of the control, which is stored in the contrlValue field of the control structure.0

DISCUSSION

When you create a control, you specify an initial setting either in the control resource or in the value parameter of the function NewControl. You can change the setting by calling SetControlValue.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)